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The FoReM BBS system consists of 6 programs and a number of data and 
text 

files. Any file that has a 3 character extension in its file name is 
either a data file (DAT) or a text file (TXT) . It is necessary to 
move these 

files from your program disk to your working data disk before you 
attempt 

to run the bbs . After you initialize the system, These files may be 
edited as you please, but the file STATUS.TXT, must retain the same 
format 

or else the system will generate an error when a user attempts to use 
the 

profile function. 

There are 6 programs on your program disk, plus DOS,Dup and 
AUTORUN. SYS . 

You cannot substitute your own DOS/AUTORUN system for the following 
reasons : 

The autorun file contains the machine language clock for the bbs. If 
you replace 

it, the system time will never change. This program is too large to 
run under 

ATARI DOS 2 . OS or 2 . OD (let alone OS/A+) . It must be run under 
Wordmark ' s 

MYDOS 3.05,3.07 or 3.08. It will not run using MYDOS 3.14, however 
it 

will run on the ATR 8000 using the 850. As of this date, there are 
still bugs 

in the ATR's 850 emulator that keeps this program from functioning 
properly . 

The program START is a menu that allows you to select a FoReM system 
program. 

The option for the disk utilies does not send you to DOS. It selects 
the 

FoReM download file utility. 

The program INITBBS, is the program used to initialize and maintain 
your system 

message files. You can add, delete, expand, or rename and message base. 
In this 

system, the words 'message base conference ' and 'board' are used 
interchangably . INITBBS is the first program you should run to set 



up 

your system. Select option 'initialize bbs ' . the program will prompt 
you 

for how many message bases to set up, their names and how many 
sectors you 

wish to allocate for them. This system will allow up to 26 message 
bases; 

assuming you have the disk space. Each message base can only hold 
approx 46 

messages . It has been my experience that each one of these should be 
about 150 

single density sectors. If you are running double density, be aware 
that 

this program accepts numbers as 128 byte sectors. So still request 
150 

sectors. Your DOS directory will show the proper 75 double density 
sectors . 

The message files generated by this program are similar in design to 
those 

used in the AMIS system, but they are not compatible. The program 
will 

prompt you if it should initialize the password data file. The first 
time 

you init the system, you must answer yes. It will ask you how many 
sectors 

to allocate. Each password uses 50 bytes of disk space and each 
sector 

has 125 data bytes available. This is simply to pre-allocate disk 
space, 

so that as the system aquires uploaded files, it does not crash when 
attempting to save a new password. The system will automatically 
increase 

the size of the password file, if it tries to save a new password 
past 

the current end of file. 

The program MESSFIX, is a utility program used when an error occurs 
in your 

data disk. Like AMIS, this system using indexed sequential message 
files , 

which are accessed by the ATARI random access note/point routines. 

If your 

disk develops a problem such as a bad sector and you simply copy your 



message files to a new disk, you will find that they no longer 
function due 

to and error 164. This can be fixed by running MESSFIX which will 
correct 

the point values. The function in this program to rebuild the system 
configuration file does not work properly. If you have a problem 
with your 

data disk, the way to fix it is as follows: 

1) copy all good files over to a new disk. If your CONFIG.DAT file is 
bad, 

you have no choice but to reinitialize the entire system using 
INITBBS . 

2) If there was a problem in any of the message files, (either a 
DA[x] or an IS [x] file), then reinitialize that particular file 

using the 

reinitaialize one conference option of INITBBS. 

3) run MESSFIX to correct the point values. 

4) go get a mellonball shooter, the official drink of Rickey Moose. 

The program VALIDATE is used to maintain the user password file. 

With 

this program, you can change a user's name, password, access level or 
phone number. You can also do a general edit of the file requesting 
that passwords not used in any given length of time be flagged. The 
program can search for a name or password and either display or 
automatically delete it. It can also automatically delete any 
password 

not used in any given period of time more tha 30 days. The system 
has 26 levels of access. You must give yourself level 25. (0-25) 

Level 25 allows you remote sysop access, the abilty to print 
messages , 

down/upload system files, read/delete any message ... etc . 

The program DISKUTIL is a utility program to manipulate the download 
files . 

Besides the ability to delete a dl file, this program manipulates the 
qualifiers on the dl filename. These parameters are translation mode, 
program language, program application and access level required to 
download the program. 

FOREM26M.2 is the main bbs program. Upon running, you enter the 
time and the date. At this point the program will set up a display 
list 



giving you a 20 line monitor (all output is echoed to the screen) and 
a 4 line 

text window. This window will tell you a number of things about the 
current caller. Included are his name and access level, the time he 
logged on, the functions he has used (reset at mod 20=0) , his caller 
number, 

the number of callers since bootup, the current disk file in use, 
the current 850 translation mode, the number of messages in the 
system, 

and the number of messages entered since bootup. 

The program will then display a series of numbers. This program is 
so large 

that it uses the ATARI'S forced read mode to delete the initalization 
code to make room for the text buffer. 

The program will then display the current time in the center of the 
screen . 

At this time, you have three options. Pressing the OPTION key will 
toggle the sysop paging system on and off. A graphic representation 
of the 

system being on or off is shown in the lower right hand corner of the 
text window. Pressing the START key will end the program and save 
the current 

system configuration to disk. If you do not end the program in this 
way, 

the only detrimental effect will be that the caller number may not be 
correct . 

There will be no harm done to any random access file. Pressing the 
SELECT 

key will allow you local access to the system. The system will 
display 

the welcome message and return with a prompt for password. The first 
time 

you log on to the system you must apply for a password, just like 
any first time user. After you apply for a password, you must give 
youself 

password level 25. You can do this in one of 2 ways. In either 
case , 

you must save your password to disk by logging off and requesting 
that 

your password be saved. In the first method, before you log off, 
while 

at the main select prompt, hit the BREAK key. Then type GOTO 90 and 
RETURN. The system will prompt 'NEW LEVEL'. Type 25 followed by a 



RETURN. Then Type P and RETURN to verify that it was accepted. 

The other method is to logoff, and then end the BBS and run validate. 
Answer yes to the validate request to check only new users . Then 
change your 
access level to 25. 

Having level 25 does a number of things for you. 

You can: 

Read all locked messages 
Delete any message 

Route a message to the system printer 
Download any file including system files 

To download a system file, if you have level 25, when the system 
asks for a filespec, give it the entire filespec except the device 
name , 

but including an entire 3 character extender (you may have to pad 
it 

with blanks) 

To upload a system file with extender, 
access the $ remote sysop function. 

The $ function will prompt you for a XIO command number and 
filespec. You can use XIO 32,33,35 and 36 to respectively rename, 
delete , 

lock or unlock a file, you must delete a file before uploading 
a new version. 

The system operator also has priority when a caller is online. All 
system 

output that the caller sees is also echoed to the screen. When the 
system 

is waiting for input from the caller, the sysop can locally type over 
the 

callers input. In this way, you can enter commands for him. 

In addition, when the system is waiting for input, the computer's 
console 

keys have the following functions: 

OPTION stops the program at line 100. This is done because the break 
key 

does not work when the system is in the concurrent I/O modem. The 
program 

can be continued by typing CONT. 

SELECT will display 'system coming down' and log the user off. 

START will break the system into 'CHAT' mode. 

Pressing both OPTION and SELECT will allow you to change the user's 


access 



level while he is online, valid levels are 0-25. Only the sysop 
should 

be given level 25. Level 0 will not allow the user to upload or to 
enter messages. This is done to deter system crashers. 

If you should happen to hit option just slightly before select and 
you get 

stopped at line 100, type 'GOTO 90' to get to the new level prompt, 
the user will be automatically logged off if there is no input in 
approx 3 minutes . 

When the sysop is online locally, if he pages himself using option Y, 
the system will go into terminal mode. The system can then be used 
as a primative terminal emulator to call other computers and bbs ' s . 
The translation mode will be whatever mode the bbs was in, so to 
switch it, you use main menu option A. To switch to ASCII mode, 
instead of hitting return at the prompt, hit any other key. 

Random notes : 

To exit from CHAT mode, press the ESCAPE key. 

When in local mode, if you use the Y command, the system becomes a 
simple 

terminal emulator. This is normally in ATASCII translation. 

However, 

you can switch to ASCII, by using the A command before the Y command 
and hitting any key except RETURN at the hit <RETURN> prompt. 

There is a small amount of command stacking available. 

When changing conferences, you can use z-x;from-to or #;#;#;# 

where x is the conference number and from and to are numeric values 

or where # are valid message numbers. 

z-x;e will route you to enter message on board #x 

With z-x;m you change boards and go to the main select prompt. 

When in the read message section, at the READ, TITLES , QUIT prompt 
you can use r; [list] or t; [list] where list is either a message 
range or list of message numbers. 

+ and - for full forward or reverse work here as well. 

Also when reading messagess, the reply, delete and main menu 
parameters 

at the end of a message can be queued so that 

d/r/m d/r d/m r/m r/d/d r/d all work, m must always be last. 

As of this moment, P cannot be used in a queue. 

It is preferable to have the d go before r so that an extra message 
is not 

rolled off the index queue. 

When uploading or downloading, in any place a d or u is requested by 



a prompt, you can use the d or u followed by a delimiter and then 
the filename, ex. D;AMPLUS83 

U; FOREMDOC 

A level 25 response would be D: PAS. DAT 

Yes, a user with level 25 can download your password file, so don't 
give it out. It is for sysop only. 

Little things the system does: 

There is a SYSUSR option on the message system. 

If a message is addressed to sysusr:x where x is a password level 
from 0 to 24, 

the message will be flagged as mail to any user with a password level 
greater than or equal to x . If the message is locked, only these 
users 

will be able to read it. 

There is no equivilent to the AMIS messages program. This system 
automatically 

maintains the message files. There is only enough memory in FOREM to 
index approx 46 messages. This is a 46 element queue so that as the 
47th message 

is entered, the first one is lost. However, its is only eliminated 
from 

the index file. This is also true of a message that is deleted. It 
is 

only deleted from the index. AMIS has a program that allows you to 

edit out messages and compact the file. Although AMIS can store 

over 200 messages, they must be compacted manually. 

FoReM is all automatic. At 4 am 
(or if a caller is online at 4, immediatly after he logs off), 
the system will automatically compact the message data files, only 
if a message has been deleted from the index. 

In addition, in AMIS, if a message is attempted to be saved past the 

end 

of the random access data file, AMIS will simply not save 
the message. FoReM will save the message in a file called MTEMP.DAT, 
delete the first 5 messages from the index, compact only the message 
data base in use, and then resave the message. 

The paging system is automatically toggled off between midnight and 
7 am. Contact me if you wish to eliminate this feature. 

This system supports multiple drives without any code modification. 

It can 

run up to 8 drives in any mix of 8", 5 1/4", single sided, double 
sided, 

double density. . .etc. . . 



System logic is as follows. 

For downloads, the system will scan from drive 1 to drive 8 looking 
for 

the file. 

For uploads, the system will start at the highest number drive it 
finds 

online and scan backwards until it finds the first drive that can 
take the upload. 

ALL SYSTEM DATA, TEXT AND MESSAGE FILES MUST BE ON DRIVE 1. 

The reason it is done this way, is that the password file grows over 
time 

and the message index files are dynamic. That is that their size 
varies 

with how many messages are in the system. By uploading to the 
highest 

drives, it lessens the risk that drive 1 will be filled generating 
an error when an attempt is made to save a message or password. In 
additon, 

the system will not allow an upload that will leave less than 30 free 
128 byte sectors (15 double density) for message and password file 
growth. It is most likely that the only reason you would ever get a 
full 

disk error is that you did not allocate enough space for passwords 
using 

INITBBS and the password file grew beyond the 30 sectors allowed. If 
this 

should happen, you must delete download files from drive 1 to free up 
space, then run INITBBS to allocate more space. Remember, 1 sector 
is 

equal to 2.5 passwords. 

System requirments: 

Minumum 40k ram. This system will not work with the RAMDISK by Axlon. 
ATARI 850 

Any autoanswer modem. No Hayes Smartmodem commands are used. 

However, 

a 1200 baud version is available for use with the Hayes 1200 
Smart modem. This version will automatically detect baud rate at 
connect time . 

Any 850 comptible printer. 

1-8 drives of any ATARI compatible type. 

A version will soon be available to take advatage of the Mosaic 
64k Ram select. 



More random notes: 

You cannot use SYSTEM RESET. The ml clock routine is stored in the 
cassette buffer. When reset is hit, the os cassette initialization 
routine 

locks up the computer. 

Purpose of the user line length parameter: 

The system asks the user for his maximum line length. This does not 
add a cr/lf at end of that many character of output. Many users with 
80 column displays do not like to be restricted to 40 column lines 
when entering messages. If a user selects a line length of 41 to 80 
characters, he will be allowed to enter messages of 15 lines of that 
many characters. If he selects 40 or less, he can enter messages of 
30 lines of that many characters. A message to sysop defaults to 
15 lines of 80 characters. 

This system has a full featured line oriented text editor patterned 
after the IBM CMS editor, but obviously only in command style. It 
allows 

line gotos, string replacement, line insetions, up, down, block 
delete . . . 

It is possible to restrict access to message bases by access level. 

It is easiest in the BASIC version to restrict access as follows: 
Either access is restricted to users with an access level <= the 
conference number, or conferences above a certain number are 
restricted to users above a particular level. In either case, 
the boards not open to the user will not appear to them in mail check 
or in the list of boards to switch to. 

This program fully supports the enhanced Xmodem of AMODEM PLUS and 
MOOSE MODEM terminal emulators. Up/downloads of more than 255 
sectors 

are permitted. But ONLY WITH THOSE 2 PROGRAMS. Uploads are not 
allowed without using Xmodem. 

Coming soon to the the ACTION! version: 

Any conference can be restricted to any an particular access level 
Example board 19 may be restricted, but 20 may be open to all. 

Each function may be restricted to any level unlike the current 
version . 

(Now only level 0 may be restricted) . 

Cursor control conversion for IBM PC compatible machines, 
support for new MYDOS subdirectories . 

String search for message editor. 

Machine language code. 



Restrictions to sysusr-either by access level or by privelige in 
user password record 


Review : 

To first set up the system: 

Format a disk to use as your working data disk. 

Boot with BASIC the FoReM program disk. 

Select initialze bbs . 

Set up for however many confereces you want. 

If using a single density disk, either do not have more 
than 3 boards or give them more than 150 sectors each. 

A maximum length message, 15 lines of 80 characters 
can use about 12 sectors for storage. Most messages are 
nowhere near that long, so 46 can usually fit into that 
small a space. You should never use less than 100, as 
when the system fills up, it will constantly be compacting 
when saving messages, which is a slow process. 

Set up password file, remember each password takes 50 bytes which 
is 2.5 per sector, you should allow for at least 200 users. 

My system has about 400 valid passwords. 

Exit to main menu. 

Go to DOS. 

Move all DAT and TXT files to your working disk with DOS option C. 

Reboot with BASIC. 

Run FoReM. 

Enter date and time. 

When clock appears, press SELECT. 

Enter none for a password. 

Apply for system password. 

At main menu, hit BREAK. 

Type GOTO 90. 

Enter 25 and hit RETURN. 

Type p and RETURN to verify. 

Logoff requesting that the password be saved, (you will be prompted 

to always use y and n and not yes and no) . 

You can now log back on with sysop level . 

To validate your users passwords, either hit OPTION and SELECT while 

they are online and the system is waiting for input, or run 

validate . 


Matthew R. Singer 



